, EXPR^^AIL NO.: EL615483487US 

SYSTEM AND METHOD FOR INTERFACING NETWORK STATION SUBSYSTEMS 



TECHNICAL FIELD 

The present invention pertains to a method and design for network station 
subsystem operations, and, more particularly, to an interface reference method and system 
implemented in one embodiment in an Operational Support System Interface (OSSI) client 
manager for interaction with Cable Modem (CM) applications. 

BACKGROUND OF THE INVENTION 

The transmission of high-speed data via cable television systems involves the 
bi-directional transfer of Internet Protocol (IP) traffic over a cable system, typically an all- 
coaxial or hybrid fiber-coax (HFC) cable network. More particularly, and with reference to 
Figure 1, the transmission path over such a cable system is realized at the head end by a 
cable-modem-termination system (CMTS) and at each customer location by a cable modem 
(CM). At the head end (or hub), the interface to the data-over-cable system is known as the 
cable-modem-termination system network-side interface (CMTS-NSI). At the customer 
locations, the interface is known as the cable-modem to customer-premises-equipment 
interface (CMCI). The system functions to transparently transfer IP traffic between these 
interfaces, including, but not limited to, datagrams, Dynamic Host Configuration Protocol 
(DHCP), Internet Control Message Protocol (ICMP), and IP group addressing (broadcast and 
multicast). 

As described more fully in co-pending U.S. patent application number 
09/464,637, entitled Network Station Management System and Method, which is 
incorporated herein in its entirety, a networking manager is a cable modem management task 
interacting with the application-layer Internet Protocol (IP) components in order to establish 
and manage Internet connectivity. These IP components can include: 

1 . Dynamic Host Configuration Protocol (DHCP) Client 

2. Trivial File Transfer Protocol (TFTP) for Configuration Download 
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3. Time of Day (TOD) Client 

4. TFTP for New Software Download 

5. Simple Network Management Protocol (SNMP) Agent 

Each application-layer component is designed to run as a separate task. Each 
5 of these tasks use a messaging system (in this particular case Operating System (OS) 
provided messaging system) and send data to the networking manager in the body of the 
messages. This task design also enables the networking manager to perform other cable 
modem management functions (improving CPU bandwidth utilization) by checking on the 
application-layer task messages only as needed. 
10 The Operations Support System Interface (OSSI) Management component is 

designed on the Object Oriented Design concept base. The reason for this is to allow 
a sufficient flexibility to deal with the ever-changing OSSI requirements largely depending on 
Jff control mechanisms through Management Information Base (MIB) Objects. The cable 

: :,: 

S3 modem OSSI Client Manager is a task created at boot time. It has its own message queue to 
?i 1 5 receive work from the Application-layer tasks or from the networking manager task and it 

Hi sends messages to the networking manager task. 

Ul 

s Thus, the OSSI subsystem architecture is based on a simplified component 

h object model. Each component in this architecture can act as a server or a client. A server 
Hf component implements a certain functionality set. It exposes its functionality set through 
□ 20 interfaces. An interface is an invariant contract that defines the interaction between the 
~ server and the client components. An interface is represented by a set of methods whose 

signatures (function prototypes) never change but whose implementation may change. 

For a client to use methods in a server's interface, a client must be able to 

access the functions through the interface. Hence, there is a need for a method and 
25 architecture that enables rapid and efficient client access to the functions embodied in a 

server interface. 
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SUMMARY OF THE INVENTION 

The disclosed embodiments of the present invention pertain to a network 
station subsystem architecture that uses a simplified interface reference discovery method. 
More particularly, in one embodiment a method for managing client-server communications 
is disclosed that includes providing a server with functions and interface methods; providing 
a client with references to the interface methods; and processing client requests by invoking 
the interface methods on the server via the references. In accordance with one aspect of this 
embodiment, the interface methods comprise providing the server with a table of pointers to 
the functions, and providing the client with references to the table of pointers, ideally at the 
time of design. 

In accordance with another embodiment, a method for network device 
subsystem operations is provided. The method includes implementing a first component in 
the network device, the first component having functions and function pointers 
corresponding to the functions; implementing a second component in the network device, the 
second component having references to the function pointers in the first component; 
generating a request from the first component for a function in the second component via the 
corresponding reference to the function pointer; and generating a response from the second 
component to provide the requested function to the first component. 

In accordance with another embodiment of the invention, a network device is 
provided that includes a server component configured with a plurality of functions and 
function pointers for the plurality of functions; a client component configured with references 
to the function pointers; and an interface manager configured to receive requests for 
functions from the client component and to invoke the requested functions from the server 
component via the function pointers. 

In accordance with yet another embodiment, a system for managing 
communications in a network station for a data-over-cable network having a plurality of 
network stations is provided. The system includes a plurality of components in the network 
station, each of the plurality of components having a functionality set and a table of pointers 




for the functionality set; a station manager having references to the tables of pointers in the 
plurality of components; and an interface manager for communication with the plurality of 
components and the station manager, the interface manager configured to process station 
manager requests for functionality from the components through the interface manager via 
5 the references to the tables of pointers. 



BRIEF DESCRIPTION OF THE DRAWINGS 

The foregoing will be more readily understood from the following detailed 
description when taken in conjunction with the accompanying drawings, wherein: 
10 Figure 1 is a diagram of transparent IP traffic through a data-over-cable 

p system; and 

JJj Figure 2 is a diagram of the general interface with the OSSI client manager in 

&j accordance with one embodiment of the present invention. 

LP 

-HJ DETAILED DESCRIPTION OF THE INVENTION 

y i 

Q 1 5 A. Architectural Concepts 

f5 The OSSI subsystem interacts with a Cable Modem Manager on a 

y Request/Response basis. A general view of the interaction among the Cable Modem Manager 
and the OSSI subsystem, in this case the OSSI Client Manager, is illustrated in Figure 2. 
Generally, the CM Manager is configured to generate a request to the OSSI Client Manager 
20 in the OSSI subsystem. The OSSI Client Manager is configured to process the request and to 
generate a response to the CM Manager. 

Based on the request contents, the OSSI Client Manager determines which 
components need to be used in order to fulfill the request. The OSSI Client Manager then 
will invoke the methods in the appropriate component interfaces. In one embodiment, the 
25 CM Manager and the OSSI Client Manager reference the component functions by pointers, 
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ideally stored in a table of pointers in each component interface. All the data storage 
referenced by the pointer in the request message can be in the shared system memory area. 

B. Design 

1 . OSSI Client Manager Task 
5 The OSSI Client Manager is designed to run as a single threaded out of 

process application task. The Cable Modem Manager (CMM) creates the OSSI Client 
Manager task during the cable modem initialization phase by calling an API 
ossi_task_create. 

The task priority of the OSSI Client Manager task depends on the hardware 
OlO and RTOS platforms. The following Table 1 shows an example of task priority assignment 
m on two platforms. 



Task Name 


ST20/OS20-JEI Build 


Explorer/PTV 


Single Ethernet 


Bridge Capable 


ossi_client_manager 


10 


8 


10 



Table 1 - OSSI Client Manager task priority assignment 



m 2. Interface with OSSI Client Manager 

y 15 The external interface between the Cable Modem applications and the OSSI 

system is based on a message system. Two message queues (Request Message Queue and 
Response Message Queue) are used. The Request Message Queue and the Response 
Message Queue are created and initialized by the OSSI Client Manager, 
a. Request Message Queue 
20 The Cable Manager requests a specific function to be performed by the OSSI 

Client Manager by queuing a request message into the Request Message Queue. The Cable 
Modem Manager can queue multiple request messages in the Request Message Queue. But 
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the OSSI Client Manager can only service one request message at a time (based on first 
comes first serves policy). The general format of the Request Message is defined in Table 2. 
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Request Function Code 



Component ID Interface ID 



15 



14 



13 



12 



11 
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Function Specific Parameter 0 



Function Specific Parameter 1 



Function Specific Parameter 2 



Function Specific Parameter 3 



Table 2 - The general format of the Request Message 



i. Request Function Code (word 0, bits 31-16) 
The Request Message Code is composed of two ID fields (Component and 
Interface). These two ID fields are mainly for OSSI Client Manager internal use. When the 
OSSI Client Manager receives the Request Message, the OSSI Client Manager picks up the 
Component ID from the Request function code to determine which Management Component 
will respond to this request from the OSSI Management Component table. Once the OSSI 
Management component has been identified. The OSSI Client Manager picks up the 
Interface ID from the Request Function Code. The OSSI Client Manager uses the Interface 
ID as a reference pointer within the identified Component Interface Table to fetch the 
function pointer of the interface method to be invoked. Each request function code is 
uniquely defined in Table 3. 



Request Function 


Component ID 


Interface ID 


Request Function Code 


OUllWoIC UpglaUC 


0 1 -Con fi duration 
Management 


00 


0x0100 


Fnahlp PPF/CM TP 

Host Communication 


02-Fault 
Management 


00 


0x0200 


<start CPF/CM TP Host 
Communication 


02-Fault 
Management 


01 


0x0201 


Fvptit "NntifiPfltinn 


02-Fault 
Management 


02 


0x0202 


flpan-T Tn Fvpnt T 
vicaii uu J— < v v^i n LiUg 


02-Fault 

\J 4- X Hull 

Management 


03 


0x0203 


Copy Event Log from 
NVS to DRAM 


02-Fault 
Management 


04 


0x0204 


Copy Event Log from 
DRAM to NVS 


02-Fault 
Management 


05 


0x0205 


Reset Event Log 


02-Fault 
Management 


06 


0x0206 



Table 3 - Request Function Codes 



ii. Function Specific Parameter 0 (word 0, bits 15-0) 
Function Specific Parameter 1 (word 1, bits 31 - 0) 
Function Specific Parameter 2 (word 2, bits 31 - 0) 
Function Specific Parameter 3 (word 2, bits 31-0) 

All four Function Specific Parameter fields are used to pass any input 
parameters required for the execution of the requesting function. For those not used 
parameter fields should be set with a value of zero. Since the OSSI components execute in- 
process, no marshaling and unmarshaling of the parameters is required. 

b. Response Message Queue 

The OSSI Client Manager returns the completion status and response 
information of the requested functions (besides the Event Notification request) in the 
response message. All unused fields should be set with a value of zero. The general format 
of the Response Message is defined in Table 4. 
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Completion Status 



Response Information 0 



Response Information 1 



Not Used(O) 



Table 4 - The general format of the Response Message 
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3. Supported Request Functions 

a. Software Upgrade (0x0 1 00) 

When the Cable Modem Manager recognizes there is a need for software 
upgrade, either from the Configuration file or from the SNMP Manager, the Cable Modem 
Manager sends this Software Upgrade request message to the OSSI Client Manager. It also 
specifies a pointer to the TFTP server IP address in Function Specific Parameter 1 and a 
pointer to the software upgrade image's name in Function Specific Parameter 2 in the 
Request Message. The format of the Software Download from the Configuration file 
M, 10 Request Message is defined in Table 5. 
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0x0100 



15 



14 
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10 



Not Used (0) 



Pointer to TFTP Server IP Address 



Pointer to Software Upgrade Image's Name 



Not Used (0) 



Table 5 - The format of Software Upgrade Request Message 



Under normal operation, no Software Upgrade Response Message will be 
15 returned to the Cable Modem Manager. The Cable Modem will reboot itself from its new 
software upgrade image. The OSSI Client Manager only returns a Response Message to the 
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Cable Modem Manager when there is an error detected during the software upgrade process. 
The format of the Software Upgrade Response Message is defined in Table 6. 
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0x0000 - Completed with no error. 



0x0001 


- Software Image not found. 


0x0002 


- Incompatible Software Version. 


0x0003 


- Incompatible Hardware Version. 


0x0004 


- Insufficient memory allocation. 


0x0005 


- Timeout on TFTP. 


0x0006 


- Error in header file. 


0x0007 


- Invalid Checksum. 



0x0008 - Same image, no download needed. 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 6 - The format of Software Upgrade file Response Message 



b. Enable CPE/CM IP Host Communication (0x0200) 
When the Cable Modem Manager decides to enable communication between 
the CPE and the CM IP Host, the Cable Modem Manger sends an Enable CPE/CM IP Host 
Communication request message to the OSSI Client Manager. The OSSI Client Manager 
sets an OSSICpelpHostComm bit in the OSSI status word. The format of the Enable 
CPE/CM IP Host Communication Request Message is defined in Table 7. 
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0x0200 
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Not Used (0) 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 7 - The format of Enable CPE/CM IP Host Communication Request Message 



At the completion of the Enable CPE/CM IP Host Communication request, 
the OS SI Client Manager returns a Response Message to the Cable Modem Manager. The 
format of the Enable CPE/CM IP Host Communication Response Message is defined in 
Table 8. 
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0x0200 



0x0000 - Completed with no error. 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 8 - The format of Enable CPE/CM IP Host Communication Response Message 



J c. Start CPE/CM IP Host Communication (0x020 1 ) 

When the Cable Modem Manager decides to activate the CPE/CM IP Host 
U1 Communication, the Cable Modem Manager sends a Start CPE/CM IP Host Communication 
tjj 10 request message to the OSSI Client Manager. The Start CPE/CM IP Host Communication 
f s interface enables communication between the CPE and the Cable Modem IP Host by calling 
O the Bridge component provided by the API function br_bridge_set (). After setting up the 
communication between the CPE and the Cable Modem IP Host, the OSSICpelpHostComm 
bit will be reset in the OSSI status word. The format of the Start CPE/CM IP Host 
1 5 Communication Request Message is defined in Table 9. 
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0x0200 



15 



14 



13 



12 



11 



10 



Not Used (0) 



Not Used (0) 



Not Used (0) 



03 



Not Used (0) 



Table 9 - The format of Start CPE/CM IP Host Communication Request Message 
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At the completion of the Start CPE/CM IP Host Communication request, the 
OSSI Client Manager returns a Response Message to the requestor. The format of the Start 
CPE/CM IP Host Communication Response Message is defined in Table 10. 
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0x0201 
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0x0000 - Completed with no error. 



0x0009 - OSSICpelpHostComm not set. 
OxOOOA - CPE/IP Host connection failed 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 10 - The format of Start CPE/CM IP Host Communication Response Message 



d. Event Notification (0x0202) 

Any Cable Modem component can send trap, syslog, enterprise trap, and 
event log information to remote network hosts by sending an Event Notification request 
message to the OSSI Client Manager. A predefined event code will be specified in the 
function specific parameter 1 field. When the Event Code in the parameter 1 specifies this 
event is for sending Enterprise Trap, the requestor needs to specify the predefined Enterprise 
Trap number in the parameter 2 field. When sending an enterprise trap and the reported MIB 
object is an element of MIB object table, an interface index is required in the function 
specific parameter 3 field such that OSSI can reference that particular MIB object in the MIB 
object table. The OSSI Client Manager determines the appropriate action (trap, syslog or 
event log) to be taken by examining the event code. Any trap or syslog that cannot be 
reported at that time will be logged in the event log. The format of the Event Notification 
Request Message is defined in Table 1 1 . 
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Not Used (0) 



Event Code 



Enterprise Trap number 



Interface Index within the mib object table (for Enterprise Trap only) 



Table 11 - The format of Event Notification Request Message 

At the completion of the Event Notification request, no Response Message is 
returned to the requestor. 



e. Clean-Up Event Log (0x0203) 

An unexpected power loss can garble a log entry in the event log. The Cable 
Modem Manager can recognize a garbled event log entry by checking the 
OSSINvsLogWritePending bit set in the OSSI status word during a subsequent system boot 
time and it must remove an incomplete log entry. The Cable Modem Manager sends this 
Clean-Up Event Log request message to the OSSI Client Manager. The OSSI Client 
Manager will remove the garbled log entry from the event log and reset the 
OSSINvsLogWritePending bit in the OSSI status word. The format of the Clean-Up Event 
Log Request Message is defined in Table 12. 
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0x0203 
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14 
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Not Used (0) 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 12 - The format of Clean-Up Event Log Request Message 

At the completion of the Clean-Up Event Log request, the OSSI Client 
Manager returns a Response Message to the Cable Modem Manager. The format of the 
Clean-Up Event Log Response Message is defined in Table 13. 
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0x0000 - Completed with no error. 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 13 - The format of Clean-Up Event Log Response Message 



f. Copy Event Log from NVS to DRAM 

In order to synchronize the event log in the system memory (DRAM) with 
Non- Volatile Store Memory (NVS) during the Cable Modem initialization, the Cable Modem 
Manager sends this Copy Event Log from Non- Volatile Store Memory (NVS) to the system 
memory (DRAM) request message. The format of the Copy Event Log from NVS to DRAM 
is defined in the Table 14. 
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Not Used (0) 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 14 - The format of Copy Event Log from NVS to DRAM Request Message 



At the completion of the Copy Event Log from NVS to DRAM request, the 
OSSI Client Manager returns a Response Message to the Cable Modem Manager. The 
format of the Copy Event Log from NVS to DRAM Response Message is defined in 
Table 15. 
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0x0000 - Completed with no error. 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 15 - The format of Copy Event Log from NVS to DRAM Response Message 



g. Copy Event Log from DRAM to NVS 

In order to elongate the life of the Non- Volatile Store Memory, it is necessary 
to reduce the frequency of writing data to the Non- Volatile Store Memory (NVS). All event 
logs are stored in the system memory (DRAM) rather than in the Non-Volatile Store Memory 
(NVS) when the logging occurs. The Cable Modem synchronizes the event logs in the 
system memory (DRAM) and the Non- Volatile Store Memory (NVS) periodically every 30 
seconds by writing back to the NVS if there is any change in the event logs. The format of 
the Copy of Event Log from DRAM to NVS Request Message is defined in Table 16. 
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Not Used (0) 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 16 - The format of Copy Event Log from DRAM to NVS Request Message 



At the completion of the Copy Event Log from the DRAM to NVS request, 
the OSSI Client Manager returns a Response Message to the Cable Modem Manager. The 
format of the Copy Event Log from DRAM to NVS Response Message is defined in 
Table 17. 
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0x0000 - Completed with no error. 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 17 - The format of Copy Event Log from DRAM to NVS Response Message 



h. Reset Event Log 

When the Cable Manager receives a SNMP Set Request for the 
docsDevEvControl mib object with a value of resetlog (1), the Cable Manager sends this 
Reset Event Log request message to the OS SI Client Manager. The format of the Reset 
Event Log Request Message is defined in Table 18. 
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Not Used (0) 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 18 - The format of Reset Event Log Request Message 

At the completion of the Reset Event Log request, the OS SI Client Manager 
returns a Response Message to the Cable Modem Manager. The format of the Reset Event 
Log Response Message is defined in Table 19. 
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0x0206 



0x0000 - Completed with no error. 



Not Used (0) 



Not Used (0) 



Not Used (0) 



Table 19 - The format of Reset Event Log Response Message 
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From the foregoing it will be appreciated that, although specific embodiments 
of the invention have been described herein for purposes of illustration, various 
modifications may be made without deviating from the spirit and scope of the invention. 
Accordingly, the invention is not limited except as by the appended claims and the 
equivalents thereof. 
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